<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252">
	<TITLE></TITLE>
	<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.4  (Win32)">
	<META NAME="AUTHOR" CONTENT="TakeAction">
	<META NAME="CREATED" CONTENT="20080715;13360000">
	<META NAME="CHANGED" CONTENT="20080722;18063624">
	<STYLE TYPE="text/css">
	<!--
		@page { size: 8.5in 11in; margin: 1in }
		H1 { margin-top: 0.33in; margin-bottom: 0in; direction: ltr; color: #365f91; line-height: 115%; page-break-inside: avoid; widows: 2; orphans: 2 }
		H1.western { font-family: "Cambria", serif; font-size: 14pt; so-language: en-US }
		H1.cjk { font-family: "Times New Roman", serif; font-size: 14pt }
		H1.ctl { font-family: "Times New Roman", serif; font-size: 14pt; so-language: ar-SA }
		P { margin-bottom: 0.08in; direction: ltr; color: #000000; line-height: 115%; widows: 2; orphans: 2 }
		P.western { font-family: "Calibri", sans-serif; font-size: 11pt; so-language: en-US }
		P.cjk { font-family: "Calibri", sans-serif; font-size: 11pt }
		P.ctl { font-family: "Calibri", sans-serif; font-size: 11pt; so-language: ar-SA }
		H2 { margin-top: 0.14in; margin-bottom: 0in; direction: ltr; color: #4f81bd; line-height: 115%; page-break-inside: avoid; widows: 2; orphans: 2 }
		H2.western { font-family: "Cambria", serif; font-size: 13pt; so-language: en-US }
		H2.cjk { font-family: "Times New Roman", serif; font-size: 13pt }
		H2.ctl { font-family: "Times New Roman", serif; font-size: 13pt; so-language: ar-SA }
	-->
	</STYLE>
</HEAD>
<BODY LANG="en-US" TEXT="#000000" DIR="LTR">
<H1 CLASS="western" STYLE="margin-bottom: 0.2in">WoW VoiceBox</H1>
<P CLASS="western" STYLE="margin-bottom: 0.14in"><FONT COLOR="#4f81bd"><FONT FACE="Cambria, serif"><FONT SIZE=3><I>A
speech recognition program for World of Warcraft</I></FONT></FONT></FONT></P>
<H2 CLASS="western" STYLE="margin-bottom: 0.2in">About</H2>
<P CLASS="western" STYLE="margin-bottom: 0.14in">WoW VoiceBox is
deisgned to allow for key presses and macros to be mapped to voice
commands. It also allows voice control of in-game chat channels, so
you can chat directly without having to pause what you're doing. All
commands can be either broadcast to all copies of WoW on the local
machine or sent only to the focused window.</P>
<H2 CLASS="western" STYLE="margin-bottom: 0.2in">Requirements</H2>
<UL>
	<LI><P CLASS="western" STYLE="margin-bottom: 0.14in">Windows Vista
	    and Windows 7 (32 or 64 bit)</P>
	<LI><P CLASS="western" STYLE="margin-bottom: 0.14in">Microphone</P>
	<LI><P CLASS="western" STYLE="margin-bottom: 0.14in">World of
	Warcraft</P>
</UL>
<H2 CLASS="western" STYLE="margin-bottom: 0.2in; line-height: 115%; widows: 2; orphans: 2">
Basic Usage</H2>
<P CLASS="western" STYLE="margin-bottom: 0.14in; line-height: 115%; widows: 2; orphans: 2">
When you first start up the program, you should see a very faint
window. This is designed to lay over the game screen in an area that
you don't have to click on. When you mouse over the window or it is
accepting dictation, it will become less transparent. 
</P>
<P CLASS="western" STYLE="margin-bottom: 0.14in; line-height: 115%; widows: 2; orphans: 2">
To use the program, all you have to do is say a valid command. For
now, you'll have to refer to the list of commands in the command
editor to see what commands are available. If you say a command that
does not require dictation, the program will immediately enter that
command to the game as soon as it is recognized. 
</P>
<P CLASS="western" STYLE="margin-bottom: 0.14in; line-height: 115%; widows: 2; orphans: 2">
If the command given allows for dictation, such as using a chat
channel, then the program's window will appear and the program will
begin accepting dictation. When you are done dictating, pause briefly
to allow the program to process your message, then say &ldquo;Send&rdquo;.
If the dictation was recognized incorrectly, you can say &ldquo;Clear&rdquo;
to erase it.</P>
<P CLASS="western" STYLE="margin-bottom: 0.14in; line-height: 115%; widows: 2; orphans: 2">
To quit the program, simply hit the quit button or say &ldquo;Quit&rdquo;.
</P>
<P CLASS="western" STYLE="margin-bottom: 0.14in; line-height: 115%; widows: 2; orphans: 2">
<BR><BR>
</P>
<H2 CLASS="western" STYLE="margin-bottom: 0.2in; page-break-after: avoid">
Using the command editor</H2>
<P CLASS="western" STYLE="margin-bottom: 0.14in">To open the command
editor, simply say &ldquo;Options&rdquo;.  The options dialog
should appear.  Choose the &quot;Commands&quot; tab.&nbsp; On the left is a list of all the commands currently
loaded.  You can add or delete commands with the buttons below the
list.  To view the details of a command, select it in the list.  
</P>
<P CLASS="western" STYLE="margin-bottom: 0.14in">The first drop down
box allows you to choose whether a command is a macro command or a
single key command.  A single key command represents a single key
press which can be modified by the modifier keys <FONT FACE="Courier New, monospace"><B>control</B></FONT>,
<FONT FACE="Courier New, monospace"><B>alt</B></FONT> and <FONT FACE="Courier New, monospace"><B>shift</B></FONT>.
 A macro command is a command of several characters that will be
entered at the same time. Macro commands can also contain a dictation
tag that allows the user to dictate text for talking in chat
channels. Both types of commands can either be sent to the window
with focus or broadcast to all WoW windows.</P>
<P CLASS="western" STYLE="margin-bottom: 0.14in">Next comes the Voice
Command box.  This is where you enter what you will say to trigger
this command.   Following that is the Broadcast checkbox.  This
determines if this command will be sent to all instances of WoW or
only the one with focus.</P>
<P CLASS="western" STYLE="margin-bottom: 0.14in">Finally, you will
see one of two text boxes, depending on the type of command.  For a
macro command, there is a box for you to enter the macro that will be
sent to the game.  To allow for dictation in a macro command, put {0}
somewhere in the macro.  Now when you trigger that command, the
program will go into dictation mode as described above, and the {0}
will be replaced with the dictated text.  
</P>
<P CLASS="western" STYLE="margin-bottom: 0.14in">If you are looking
at a single key command, the text box will show the windows key code
for this command along with any modifier keys.  To change the key,
simply click in the box and hit the key you want.  Note that
sometimes the keys may have weird names. For example, the standard
number keys 0-9 show up as D0-D9.  Don't worry about it, it should
still work.</P>
<P CLASS="western" STYLE="margin-bottom: 0.14in">When you are done
making changes, hit OK and all the changes you have made will be
saved to the configuration file.  You can also hit cancel to undo any
changes.</P>
<P CLASS="western" STYLE="margin-bottom: 0.14in"><BR><BR>
</P>
<H2 CLASS="western" STYLE="margin-bottom: 0.2in">Setting up the XML
commands file &ndash; Advanced users only</H2>
<P CLASS="western" STYLE="margin-bottom: 0.14in">This part is now
outdated with the introduction of the commands editor.  It is kept
for reference and advanced users only.&nbsp; Settings for the application are stored 
    in the following path:</P>
    <P CLASS="western" STYLE="margin-bottom: 0.14in">
        C:\Users\(username)\AppData\Local\WowVoiceBox</P>
<P CLASS="western" STYLE="margin-bottom: 0.14in">WoW VoiceBox uses an
XML file to store all of its commands which can be edited in Wordpad.
There are two basic types of commands, <FONT FACE="Courier New, monospace"><B>commandkey
</B></FONT>and <FONT FACE="Courier New, monospace"><B>commandstring</B></FONT>.
The <FONT FACE="Courier New, monospace"><B>commandkey</B></FONT>
represents a single key press which can be modified by the modifier
keys <FONT FACE="Courier New, monospace"><B>control</B></FONT>, <FONT FACE="Courier New, monospace"><B>alt</B></FONT>
and <FONT FACE="Courier New, monospace"><B>shift</B></FONT>. The
<FONT FACE="Courier New, monospace"><B>commandstring</B></FONT>
represents a macro style command of several characters that will be
entered at the same time. <FONT FACE="Courier New, monospace"><B>commandstring</B></FONT>
can also contain a dictation tag that allows the user to dictate text
for talking in chat channels. Both types of commands can either be
sent to the window with focus or broadcast to all WoW windows.</P>
<P CLASS="western" STYLE="margin-bottom: 0.14in">The setup of a
<FONT FACE="Courier New, monospace"><B>commandkey</B></FONT> looks
like this:</P>
<P CLASS="western" STYLE="margin-bottom: 0in; line-height: 100%"><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&lt;</FONT></FONT></FONT><FONT COLOR="#a31515"><FONT FACE="Courier New, monospace"><FONT SIZE=2>command</FONT></FONT></FONT><FONT COLOR="#0000ff">
</FONT><FONT COLOR="#ff0000"><FONT FACE="Courier New, monospace"><FONT SIZE=2>voice</FONT></FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>=</FONT></FONT></FONT><FONT FACE="Courier New, monospace"><FONT SIZE=2>&quot;</FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>Thorns</FONT></FONT></FONT><FONT FACE="Courier New, monospace"><FONT SIZE=2>&quot;</FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;</FONT></FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; line-height: 100%"><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&lt;</FONT></FONT></FONT><FONT COLOR="#a31515"><FONT FACE="Courier New, monospace"><FONT SIZE=2>commandKey</FONT></FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;</FONT></FONT></FONT><FONT FACE="Courier New, monospace"><FONT SIZE=2>30</FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&lt;/</FONT></FONT></FONT><FONT COLOR="#a31515"><FONT FACE="Courier New, monospace"><FONT SIZE=2>commandKey</FONT></FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;</FONT></FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; line-height: 100%"><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&lt;</FONT></FONT></FONT><FONT COLOR="#a31515"><FONT FACE="Courier New, monospace"><FONT SIZE=2>modifier</FONT></FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;</FONT></FONT></FONT><FONT FACE="Courier New, monospace"><FONT SIZE=2>Ctrl</FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&lt;/</FONT></FONT></FONT><FONT COLOR="#a31515"><FONT FACE="Courier New, monospace"><FONT SIZE=2>modifier</FONT></FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;</FONT></FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; line-height: 100%"><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&lt;</FONT></FONT></FONT><FONT COLOR="#a31515"><FONT FACE="Courier New, monospace"><FONT SIZE=2>modifier</FONT></FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;</FONT></FONT></FONT><FONT FACE="Courier New, monospace"><FONT SIZE=2>Alt</FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&lt;/</FONT></FONT></FONT><FONT COLOR="#a31515"><FONT FACE="Courier New, monospace"><FONT SIZE=2>modifier</FONT></FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;</FONT></FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; line-height: 100%"><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&lt;/</FONT></FONT></FONT><FONT COLOR="#a31515"><FONT FACE="Courier New, monospace"><FONT SIZE=2>command</FONT></FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;</FONT></FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0.14in"><BR><BR>
</P>
<P CLASS="western" STYLE="margin-bottom: 0.14in">The attribute <FONT FACE="Courier New, monospace"><B>voice</B></FONT>
in the <FONT FACE="Courier New, monospace"><B>command</B></FONT> tag
is used to set what you have to say to activate this command. The
<FONT FACE="Courier New, monospace"><B>commandkey</B></FONT> node
identifies this as a single key command. Note that <FONT FACE="Courier New, monospace"><B>commandkey</B></FONT>
and <FONT FACE="Courier New, monospace"><B>commandstring</B></FONT>
are mutually exclusive. The inner text of the <FONT FACE="Courier New, monospace"><B>commandkey</B></FONT>
node represents the Windows key code in hexadecimal format. This one
happens to be the &lsquo;0&rsquo; key. The modifier nodes indicate
which modifier keys should be pressed in addition to the main key, in
this case, Ctrl and Alt. So now when you say &ldquo;Thorns&rdquo;,
the program will send Crtl+Alt+0 to the focused window. In game, you
would map this key combination to Thorns. A list of the key code
values can be found here:
<FONT COLOR="#008000"><FONT SIZE=2 STYLE="font-size: 11pt"><A HREF="http://msdn.microsoft.com/en-us/library/ms927178.aspx">http://msdn.microsoft.com/en-us/library/ms927178.aspx</A>.
</FONT></FONT>Use the value in the &ldquo;Hexadecimal value&rdquo;
column.</P>
<P CLASS="western" STYLE="margin-bottom: 0.14in">Setting up a
<FONT FACE="Courier New, monospace"><B>commandstring</B></FONT> is
similar, but a little bit different. Here is the basic <FONT FACE="Courier New, monospace"><B>command</B></FONT>
for yelling something in chat via the dictation.</P>
<P CLASS="western" STYLE="margin-bottom: 0in; line-height: 100%"><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&lt;</FONT></FONT></FONT><FONT COLOR="#a31515"><FONT FACE="Courier New, monospace"><FONT SIZE=2>command</FONT></FONT></FONT><FONT COLOR="#0000ff">
</FONT><FONT COLOR="#ff0000"><FONT FACE="Courier New, monospace"><FONT SIZE=2>voice</FONT></FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>=</FONT></FONT></FONT><FONT FACE="Courier New, monospace"><FONT SIZE=2>&quot;</FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>Yell</FONT></FONT></FONT><FONT FACE="Courier New, monospace"><FONT SIZE=2>&quot;</FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;</FONT></FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; line-height: 100%"><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&lt;</FONT></FONT></FONT><FONT COLOR="#a31515"><FONT FACE="Courier New, monospace"><FONT SIZE=2>commandString</FONT></FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;</FONT></FONT></FONT><FONT FACE="Courier New, monospace"><FONT SIZE=2>/y
{0}</FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&lt;/</FONT></FONT></FONT><FONT COLOR="#a31515"><FONT FACE="Courier New, monospace"><FONT SIZE=2>commandString</FONT></FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;</FONT></FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; line-height: 100%"><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&lt;</FONT></FONT></FONT><FONT COLOR="#a31515"><FONT FACE="Courier New, monospace"><FONT SIZE=2>displayString</FONT></FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;</FONT></FONT></FONT><FONT FACE="Courier New, monospace"><FONT SIZE=2>Yell:</FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&lt;/</FONT></FONT></FONT><FONT COLOR="#a31515"><FONT FACE="Courier New, monospace"><FONT SIZE=2>displayString</FONT></FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;</FONT></FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; line-height: 100%"><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&lt;/</FONT></FONT></FONT><FONT COLOR="#a31515"><FONT FACE="Courier New, monospace"><FONT SIZE=2>command</FONT></FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;</FONT></FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0.14in"><BR><BR>
</P>
<P CLASS="western" STYLE="margin-bottom: 0.14in">Again, the voice
command you actually say is &ldquo;Yell&rdquo;, as indicated by the
<FONT FACE="Courier New, monospace"><B>voice</B></FONT> attribute.
The <FONT FACE="Courier New, monospace"><B>displaystring</B></FONT>
tag contains what will be displayed on the user interface while the
program is accepting dictation. The <FONT FACE="Courier New, monospace"><B>commandstring</B></FONT>
tag contains the actual command that will be sent to the game, where
&ldquo;{0}&rdquo; is replaced with the dictated text. 
</P>
<P CLASS="western" STYLE="margin-bottom: 0.14in">For simpler commands
like a standard macro, it&rsquo;s pretty much the same. Here&rsquo;s
one that will make all your guys dance.</P>
<P CLASS="western" STYLE="margin-bottom: 0in; line-height: 100%"><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&lt;</FONT></FONT></FONT><FONT COLOR="#a31515"><FONT FACE="Courier New, monospace"><FONT SIZE=2>command</FONT></FONT></FONT><FONT COLOR="#0000ff">
</FONT><FONT COLOR="#ff0000"><FONT FACE="Courier New, monospace"><FONT SIZE=2>voice</FONT></FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>=</FONT></FONT></FONT><FONT FACE="Courier New, monospace"><FONT SIZE=2>&quot;</FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>Dance</FONT></FONT></FONT><FONT FACE="Courier New, monospace"><FONT SIZE=2>&quot;
</FONT></FONT><FONT COLOR="#ff0000"><FONT FACE="Courier New, monospace"><FONT SIZE=2>broadcast</FONT></FONT></FONT><FONT FACE="Courier New, monospace"><FONT SIZE=2>=&rdquo;</FONT></FONT><FONT COLOR="#548dd4"><FONT FACE="Courier New, monospace"><FONT SIZE=2>1</FONT></FONT></FONT>&rdquo;<FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;</FONT></FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; line-height: 100%"><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&lt;</FONT></FONT></FONT><FONT COLOR="#a31515"><FONT FACE="Courier New, monospace"><FONT SIZE=2>commandString</FONT></FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;</FONT></FONT></FONT><FONT FACE="Courier New, monospace"><FONT SIZE=2>/dance</FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&lt;/</FONT></FONT></FONT><FONT COLOR="#a31515"><FONT FACE="Courier New, monospace"><FONT SIZE=2>commandString</FONT></FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;</FONT></FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0in; line-height: 100%"><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&lt;/</FONT></FONT></FONT><FONT COLOR="#a31515"><FONT FACE="Courier New, monospace"><FONT SIZE=2>command</FONT></FONT></FONT><FONT COLOR="#0000ff"><FONT FACE="Courier New, monospace"><FONT SIZE=2>&gt;</FONT></FONT></FONT></P>
<P CLASS="western" STYLE="margin-bottom: 0.14in"><BR><BR>
</P>
<P CLASS="western" STYLE="margin-bottom: 0.14in">The only thing new
there is the broadcast attribute, which tells it to send the command
to all windows. Broadcast can be applied to either type of command.</P>
</BODY>
</HTML>